- Überblick
- UI-Automatisierung (UI Automation)
- UI-ANA-016 – URL zum Öffnen eines Browsers abrufen
- UI-ANA-017 – ContinueOnError True
- UI-ANA-018 – OCR-/Bildaktivitäten auflisten
- UI-DBP-006 – Containernutzung
- UI-DBP-013 – Falscher Gebrauch von Excel-Automatisierung
- UI-DBP-030 – Verwendung unzulässiger Variablen in Selektoren
- ST-DBP-021 – Hartcodiertes Timeout
- UI-PRR-001 – Klick simulieren
- UI-PRR-002 – Typ simulieren
- UI-PRR-003 – Offener Anwendungsmissbrauch
- UI-PRR-004 – Hartcodierte Verzögerungen
- UI-REL-001 – Große IDX in Selektoren
- UI-SEC-004 – Selektor-E-Mail-Daten
- UI-SEC-010 – App-/URL-Einschränkungen
- UI-USG-011 – Nicht zulässige Attribute
- SY-USG-013 – Private Datei aufrufen
- SY-USG-014 – Falsche Platzhalter für Ausführungsvorlage
- Mit UI-Automatisierung automatisierte Anwendungen und Technologien
- UiPath-Browsermigrationstool
- Computer Vision Recorder
- Klicken (Click)
- Darauf zeigen (Hover)
- Sicheren Text eingeben (Type Secure Text)
- Hotkey senden (Send Hotkey)
- Eingeben in (Type Into)
- Prüfen (Check)
- Objekt auswählen (Select Item)
- Mehrere Objekte auswählen (Select Multiple Items)
- Text erhalten (Get Text)
- Text einstellen (Set Text)
- Aktivieren (Activate)
- Markieren (Highlight)
- Fokus legen auf (Set Focus)
- Ankerbasis (Anchor Base)
- Kontextbewusster Anker
- Relatives Element finden (Find Relative Element)
- Auf Bildschirm anzeigen (Indicate On Screen)
- Element vorhanden (Element Exists)
- Element finden (Find Element)
- Warten, bis Element verschwindet (Wait Element Vanish)
- Untergeordnete Elemente finden (Find Children)
- Vorgänger-Element erhalten (Get Ancestor)
- Elementumfang (Element Scope)
- Attribut erhalten (Get Attribute)
- Ausschneidebereich einstellen (Set Clipping Region)
- Position erhalten (Get Position)
- Screenshot anfertigen (Take Screenshot)
- Attribut abwarten (Wait Attribute)
- Auf Element erscheinen (On Element Appear)
- Auf Element verschwinden (On Element Vanish)
- Text anklicken (Click Text)
- Text beim Darauf zeigen (Hover Text)
- Textposition finden (Find Text Position)
- Volltext erhalten (Get Full Text)
- Sichtbaren Text erhalten (Get Visible Text)
- Strukturierte Daten extrahieren (Extract Structured Data)
- Text vorhanden (Text Exists)
- OCR-Text anklicken (Click OCR Text)
- Auf OCR-Text zeigen (Hover OCR Text)
- OCR-Text erhalten (Get OCR Text)
- OCR-Textposition finden (Find OCR Text Position)
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- Microsoft Azure ComputerVision OCR
- Tesseract OCR
- Google Cloud Vision OCR
- OCR-Text vorhanden (OCR Text Exists)
- Bild anklicken (Click Image)
- Auf Bild zeigen (Hover Image)
- Bildübereinstimmung finden (Find Image Matches)
- Bild vorhanden (Image Exists)
- Bild finden (Find Image)
- Warten, bis Bild verschwindet (Wait Image Vanish)
- Auf Bild erscheinen (On Image Appear)
- Auf Bild verschwinden (On Image Vanish)
- Bild laden (Load Image)
- Bild speichern (Save Image)
- Browser anhängen (Attach Browser)
- Registerkarte schließen (Close Tab)
- Zurück (Go Back)
- Weiter (Go Forward)
- Zur Startseite (Go Home)
- JS-Skript einfügen (Inject JS Script)
- Navigieren zu (Navigate To)
- Browser öffnen (Open Browser)
- Browser aktualisieren (Refresh Browser)
- Web-Attribut setzen (Set Web Attribute)
- Fenster anhängen (Attach Window)
- Fenster schließen (Close Window)
- Aktives Fenster abrufen (Get Active Window)
- Fenster ausblenden (Hide Window)
- Fenster maximieren (Maximize Window)
- Fenster minimieren (Minimize Window)
- Fenster verschieben (Move Window)
- Fenster wiederherstellen (Restore Window)
- Fenster anzeigen (Show Window)
- Export UI Tree
- ActiveX-Methode aufrufen
- .NET-Code einfügen
- Trigger anklicken (Click Trigger)
- Tastendruck-Trigger (Key Press Trigger)
- Bild-Trigger anklicken (Click Image Trigger)
- System-Trigger (System Trigger)
- Hotkey-Trigger (Hotkey Trigger)
- Maus-Trigger (Mouse Trigger)
- Ereignisinfo erhalten (Get Event Info)
- Ereignisse überwachen (Monitor Events)
- Quellelement erhalten (Get Source Element)
- Benutzerereignis wiedergeben (Replay User Event)
- Benutzeingabe blockieren (Block User Input)
- Vordergrund verwenden
- Element Attribute Change Trigger
- Element State Change Trigger
- Textfeld (Callout)
- Ausgewählten Text kopieren (Copy Selected Text)
- Aus Zwischenablage erhalten (Get From Clipboard)
- Auf Zwischenablage setzen (Set To Clipboard)
- Anwendung schließen (Close Application)
- Anwendung öffnen (Open Application)
- Prozess starten (Start Process)
- Passwort erhalten (Get Password)
- Tooltip
- Click Picture on Screen
- Click Toolbar Button
- Read Statusbar
- Select Dates In Calendar
- Select Menu Item
- Expand Tree
- Call Transaction
- SAP Logon
- SAP Login
- Table Cell Scope
- SAP Session Attributes Change Trigger
- Expand ALV Tree
- Expand ALV Hierarchical Table
- Use Application/Browser
- Check App State
- Check/Uncheck
- Klicken (Click)
- Extract Table Data
- Text erhalten (Get Text)
- Get URL
- Zu URL wechseln
- Markieren (Highlight)
- Darauf zeigen (Hover)
- Tastenkombinationen
- Navigate Browser
- Objekt auswählen (Select Item)
- Screenshot anfertigen (Take Screenshot)
- Eingeben in (Type Into)
- Attribut erhalten (Get Attribute)
- Get Browser Data
- Set Browser Data
- Mouse Scroll
- Inject Js Script
- Ziehen und Ablegen
- For Each UI Element
- Application event trigger
- Click Event Trigger
- Keypress Event Trigger
- Text einstellen (Set Text)
- Check Element
- Formular ausfüllen
- Anhängen
- Prüfen (Check)
- Klicken (Click)
- Ziehen und Ablegen
- Daten extrahieren
- Attribut erhalten (Get Attribute)
- GetChildren
- GetRuntimeTarget
- GetText
- Get URL
- GoToUrl
- Markieren (Highlight)
- Darauf zeigen (Hover)
- Ist aktiviert
- Tastaturkürzel (Keyboard Shortcut)
- Mouse Scroll
- Offen
- Objekt auswählen (Select Item)
- Screenshot anfertigen (Take Screenshot)
- Eingeben in (Type Into)
- Wartestatus
- Führen Sie eine Browsersuche durch und rufen Sie Ergebnisse mithilfe von UIAutomation-APIs ab
- Web-Browsing
- Finden von Bildern
- Klicken auf Bilder
- Auslösen und Überwachen von Ereignissen
- Erstellen und Überschreiben von Dateien
- HTML-Seiten: Extrahieren und Bearbeiten von Informationen
- Bearbeiten von Fenstern
- Automatisierte Listenauswahl
- Finden und Bearbeiten von Fensterelementen
- Verwalten der Textautomatisierung
- Laden und Verarbeiten von Bildern
- Verwalten von mausaktivierten Aktionen
- Automatisieren der Anwendungslaufzeit
- Automatisierte Ausführung einer lokalen Anwendung
- Browsernavigation
- Web-Automatisierung
- Beispiel für Trigger Scope
- Computer Vision Local Server
- Mobile Automation
- Versionshinweise
- Projektkompatibilität
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Install App
- Manage Current App
- Manage Other App
- DeepLink öffnen
- Open URL
- Mobile Device Connection
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Screenshot anfertigen (Take Screenshot)
- Take Screenshot Part
- Element vorhanden (Element Exists)
- Execute Command
- Attribut erhalten (Get Attribute)
- Get Selected Item
- Text erhalten (Get Text)
- Set Selected Item
- Text einstellen (Set Text)
- Wischen
- Tap
- Type Text
- Muster zeichnen
- Terminal
- Versionshinweise
- Über das Terminal-Aktivitätspaket
- Projektkompatibilität
- Terminalsitzung (Terminal Session)
- Bildschirmbereich erhalten (Get Screen Area)
- Text an Position erhalten (Get Text at Position)
- Get Color At Position
- Feld an Position erhalten (Get Field at Position)
- Feld an Position setzen (Set Field at Position)
- Warte auf Text an Position (Wait Text at Position)
- Tasten senden (Send Keys)
- Cursor bewegen (Move Cursor)
- Sichere Tasten senden (Send Keys Secure)
- Text erhalten (Get Text)
- Find Text
- Move Cursor to Text
- Strg-Taste senden (Send Control Key)
- Feld erhalten (Get Field)
- Warte auf Bildschirmtext (Wait Screen Text)
- Warte auf Feldtext (Wait Field Text)
- Feld setzen (Set Field)
JS-Skript einfügen (Inject JS Script)
UiPath.Core.Activities.InjectJsScript
Führt JavaScript-Code im Webseiten-Kontext zu einem UiElement aus.
Eingabe
-
ScriptCode - Der JavaScript-Code, den Sie ausführen möchten. Sie können den Code hier als Zeichenfolge eingeben oder den vollständigen Pfad einer
.js
-Datei angeben, die den auszuführenden Code enthält. Die Datei sollte eine einzelne, anonyme Funktion wie im folgenden Beispiel enthalten:function (element, input) { return "result"; }
function (element, input) { return "result"; }
element
für das HTML-Element, das dem aufrufenden UI-Knoten entspricht, und input
steht für die vom Aufrufer bereitgestellte Eingabezeichenfolge.
- EingabeParameter (InputParameter) - Eingabedaten für den JavaScript-Code als Zeichenfolge oder Zeichenfolgenvariable.
- Ziel.Selektor (Target.Selector) - Texteigenschaft zum Suchen eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente spezifiziert.
- Target.TimeoutMS – Gibt die Zeit (in Millisekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor der Fehler
SelectorNotFoundException
ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden). -
Ziel.WartenBisBereit (Target.WaitForReady) - Vor Ausführung der Aktionen warten, bis das Ziel bereit ist. Folgende Optionen sind verfügbar:
- Keine (None) - Wartet ausschließlich auf das UI-Zielelement, bevor die Aktion ausgeführt wird. Sie können diese Option beispielsweise verwenden, wenn Sie nur Text einer Website abrufen oder eine bestimmte Schaltfläche anklicken möchten, ohne auf das Laden aller UI-Elemente warten zu müssen. Beachten Sie, dass dies ungewünschte Folgen haben kann, wenn die Schaltfläche von Elementen wie Skripten abhängt, die noch nicht geladen sind.
-
Interaktiv/Abgeschlossen – Wartet, bis alle UI-Elemente in der Ziel-App vorhanden sind, bevor die Aktion tatsächlich ausgeführt wird.
Um zu beurteilen, ob sich eine Anwendung im Status „Interaktiv“ oder „Abgeschlossen“ befindet, werden die folgenden Tags überprüft:
- Desktop-Anwendungen (Desktop applications) - Eine Nachricht
wm_null
wird versendet, um zu prüfen, ob die Tags<wnd>
,<ctrl>
,<java>
oder<uia>
vorhanden sind. Sind die Tags vorhanden, wird die Aktivität ausgeführt. - Webanwendung
- Internet Explorer – Das
<webctrl>
-Tag wird verwendet, um zu überprüfen, ob der Status Bereit des HTML-Dokuments Abgeschlossen ist. Darüber hinaus muss der Status Beschäftigt auf „False“ festgelegt werden. - Andere – Das
<webctrl>
-Tag wird verwendet, um zu überprüfen, ob der Bereitschafts-Status des HTML-Dokuments Abgeschlossen ist.
- SAP-Anwendungen (SAP applications) - Zuerst wird geprüft, ob der Tag
<wnd>
vorhanden ist. Anschließend wird eine SAP-spezifische API verwendet, um zu prüfen, ob die Session verfügbar ist.
- Ziel.Element (Target.Element) - Verwendet die Variable UIElement, die von einer anderen Aktivität zurückgegeben wird. Die Eigenschaft kann nicht zusammen mit der Auswahleigenschaft verwendet werden. Dieses Feld unterstützt nur Variablen vom Typ UIElement.
- Target.ClippingRegion - Definiert das Ausschneide-Rechteck in Pixel im Verhältnis zum UIElement in folgenden Richtungen: links, oben, rechts, unten. Es unterstützt sowohl positive als auch negative Zahlen.
Ausgabe
- SkriptAusgabe (ScriptOutput) - Zurückgegebenes Zeichenfolgen-Ergebnis aus JavaScript-Code.
Allgemein
- AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
-
BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
Sonstiges
- Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
Optionen
-
Ausführungswelt – Die JavaScript- Umgebung für die Skriptausführung.
- Isoliert – Ermöglicht den Zugriff auf die HTML-Elemente, verhindert jedoch den Zugriff auf Seitenvariablen und Code. Verwenden Sie diese Option, um sicherzustellen, dass die Skriptausführung nicht mit der Seite in Konflikt steht.
- Seite – Lässt den Zugriff auf die HTML-Elemente, Seitenvariablen und den Code zu. Verwenden Sie diese Option, wenn Sie auf Seitenvariablen zugreifen müssen (z. B.
jQuery $
) oder mit Seitencode interagieren (z. B.window.alert
). Die Verwendung dieser Option ist erforderlich, um dieses bekannte Problem zu beheben, das spezifisch für MV3-Erweiterungen ist.
Sie können die Eigenschaft Ausführungswelt ( Execution world ) für alle Inject Js Script -Aktivitäten in den Projekteinstellungenändern.
.js
-Dateien auf diesen Seiten zu verarbeiten. Sie müssen die Browsererweiterungen installiert und aktiviert haben.
Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Beispiel erstellt, das einen Browser öffnet und eine Warnung mit dem vom Benutzer angegebenen Text anzeigt.
So kann der Automatisierungsprozess erstellt werden:
-
Öffnen Sie Studio und erstellen Sie einen neuen Prozess.
Hinweis: Stellen Sie sicher, dass sich die.js
-Datei im Projektordner befindet. In diesem Beispiel haben wirexample.js
verwendet. -
Ziehen Sie eine Sequence in den Workflow-Designer.
-
Erstellen Sie die folgenden Variablen:
Variablenname
Variablentyp
Standardwert
TextToWrite
GenericValue
-
-
Ziehen Sie eine Input Dialog-Aktivität in den Sequence-Container.
- Fügen Sie im Eigenschaftenbereich den Namen
Ask for message
in das Feld Anzeigename ein. - Fügen Sie den Ausdruck
"Please insert the text to be written on the web page."
in das Feld Beschriftung ein. - Fügen Sie die Meldung
"Please insert text"
in das Feld Titel ein. - Fügen Sie die Variable
textToWrite
in das Feld Ergebnis ein.
- Fügen Sie im Eigenschaftenbereich den Namen
-
Platzieren Sie eine Open Browser-Aktivität unter die Input Dialog-Aktivität.
- Fügen Sie die Adresse
"https://www.google.com/"
in das Feld URL ein.
- Fügen Sie die Adresse
-
Ziehen Sie eine Inject JS Script-Aktivität in den Textkörper-Container der Aktivität Open Browser.
- Fügen Sie im Eigenschaftenbereich den Namen
Show Alert
in das Feld Anzeigename ein. - Fügen Sie die Variable
TextToWrite
in das Feld Eingabeparameter ein. - Fügen Sie den Ausdruck
"Inject JS\example.js"
in das Feld Skriptcode ein.
- Fügen Sie im Eigenschaftenbereich den Namen
-
Führen Sie den Prozess aus. Der Roboter öffnet eine neue Browserseite und gibt die Warnung mit dem von Ihnen hinzugefügten Text aus.